home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / archvrs / msdos / quu21 / quudcd.doc next >
Encoding:
Text File  |  1989-01-17  |  4.1 KB  |  76 lines
  1. This  QUUDCD,  which  is  a  fast uudecoder written in assembly language.
  2. This program will  take  one  or  many  uuencoded  file[s],  and uudecode
  3. it[/them] into  the original  binary file.  The initial input file may be
  4. entered on the command line, or else the program will prompt the user for
  5. it.   Any drive  or path may be specified for the input file, but only to
  6. 80 characters  (which should be  more than enough).  IMPORTANT:  If there
  7. is more  than one  portion to  the encoded  file, they must all be in the
  8. same directory, and they  must  follow  a  particular  naming convention,
  9. explained below.   The  output file will be written to the current logged
  10. drive, and this feature cannot be overridden.  There are  no command line
  11. switches.  Usage is:
  12.  
  13.     QUUDCD [drive][path][filename.ext]
  14.  
  15. For  multipart  encoded  files,  this  program  will  search for the next
  16. encoded file portion according to these rules:  The first  uuencoded file
  17. may have  any DOS-legal  name and  extension (or even no extension).  The
  18. second uuunecoded file *MUST*  have a  '1' as  the last  character of the
  19. filename -- NOT the extension.  Or, if the last character of the filename
  20. of the first file WAS a number (ANY  number --  whether '1'  or something
  21. else,  the  last  character  of  the  second  filename must be one number
  22. higher.  Subsequent  files  must  have  filenames  ending  in  numbers of
  23. ascending order.  All other filename characters must be the same, and all
  24. files must have the same extension.
  25.  
  26. Moreover,  this  program  utilizes  a  recursive  technique  to increment
  27. filename numbers,  and is capable of "rolling around" when the last digit
  28. is a '9', and adjusting a  higher  order  digit.    It  is  even  able to
  29. "extend" a  filename, such as from '999.UUE' to '1000.UUE'.  It will not,
  30. however, extend a filename  to  more  than  8  characters  (excluding the
  31. extension).  Probably, the easiest thing to do is to name multipart files
  32. simply by number, such as '1', '2', '3', etc.
  33.  
  34. Here are some examples of filenames that will work:
  35.  
  36.     File:      Ex. 1:         Ex. 2:      Ex. 3:    Ex.4:     Ex. 5:
  37.     ----     ----------     ---------     -----     ----    ---------
  38.     1st:     abcdef.uue     file1.uue     14998      999    rstu9.xxx
  39.     2nd:     abcde1.uue     file2.uue     14999     1000    rst10.xxx
  40.     3rd:     abcde2.uue     file3.uue     15000     1001    rst11.xxx
  41.     etc.        ...            ...         ...       ...       ...
  42.  
  43. Here are a couple that won't:
  44.  
  45.     File:     Ex. 1:          Ex. 2:
  46.     ----    ----------      ----------
  47.     1st:    abcdef.uu1      file-a.uue
  48.     2nd:    abcdef.uu2      file-b.uue
  49.     3rd:    abcdef.uu3      file-c.uue
  50.     etc.       ...             ...
  51.  
  52.  
  53. This program is an "intelligent" program.  It is able to decode uuencoded
  54. files of  any length  (in addition to multiple files, as outlined above),
  55. and even to strip  out spurious  lines in  the main  body of  the encoded
  56. portion.   Thus, it  is possible  to concatenate  multipart postings to a
  57. single file (without removing headers and .signatures), and  this program
  58. will successfully  decode it.  Also, the headers and .signatures need not
  59. be edited out of individual multipart encoded files.   The  encoded files
  60. may have CRLF line end pairs, or just the single UNIX (tm) LF character.
  61.  
  62. This program  has been  designed to use large buffers, so as not to cause
  63. undue  wear  and  tear  on  disk  drives.    It  also   allocates  memory
  64. dynamically, and  it requires  a maximum  of slightly  more than 64K when
  65. decoding large files.  If you have limited  memory, or  a large  chunk of
  66. memory  dedicated  to  resident  applications,  you might not have enough
  67. memory to run this program.
  68.  
  69. This is version 2.1, which incorporates several improvements suggested by
  70. David Kirschenbaum (kirsch@braggvax.ARPA).  Also, the 1% of the code that
  71. does 99% of the work has  been tweaked  to make  it even  faster.  Please
  72. note that  there is a Copyright (C) 1988, 1989 on the program by Theodore
  73. A. Kaldis.  The program may be distributed freely, without charge.
  74.  
  75. UNIX is a trademark of AT&T
  76.